Status Handlers
Identifier:
org.eclipse.debug.core.statusHandlers
Description:
This extension point provides a mechanism for separating the generation and resolution of an error.
The interaction between the source of the error and the resolution is client-defined.
It is a client responsibility to look up and delegate to status handlers when an error condition occurs.
Configuration Markup:
<!ELEMENT extension (statusHandler*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - a fully qualified identifier of the target extension point
- id - an optional identifier of the extension instance
- name - an optional name of the extension instance
<!ELEMENT statusHandler EMPTY>
<!ATTLIST statusHandler
id CDATA #REQUIRED
class CDATA #REQUIRED
plugin CDATA #REQUIRED
code CDATA #REQUIRED>
- id - specifies a unique identifier for this status handler.
- class - specifies the fully qualified name of the Java class that implements IStatusHandler.
- plugin - Plug-in identifier that corresponds to the plug-in of the status this handler is registered for. (i.e. IStatus.getPlugin()).
- code - specifies the status code this handler is registered for.
Examples:
The following is an example of a status handler extension point:
<extension point=
"org.eclipse.debug.core.statusHandlers"
>
<statusHandler
id=
"com.example.ExampleIdentifier"
class=
"com.example.ExampleStatusHandler"
plugin=
"com.example.ExamplePluginId"
code=
"123"
>
</statusHandler>
</extension>
In the example above, the specified status handler will be registered for to handle status objects with a plug-in identifier of
com.example.ExamplePluginId and a status code of 123.
API Information:
Value of the attribute class must be a fully qualified name of a Java class that implements the interface org.eclipse.debug.core.IStatusHandler.